[更多标签]MoreTitle

MoreTitle是一个功能丰富的Minecraft服务器插件,主要用于管理玩家昵称前缀和后缀、跨服聊天以及权限组配置。该插件支持PlaceholderAPI,并提供完整的聊天系统和权限组管理功能。

适用核心 Paper 适用版本 1.20.1+ 是否付费 否 最新版本 v1.0.0

目录概要

1. 基础

插件概述

MoreTitle 插件详细介绍文档

MoreTitle 是一个功能丰富的 Minecraft 服务器插件,主要用于管理玩家昵称前缀和后缀、跨服聊天以及权限组配置。该插件支持 PlaceholderAPI,并提供完整的聊天系统和权限组管理功能。

主要特性

  • 权限组管理 - 支持自定义权限组配置,可设置每个权限组的前缀和后缀
  • 聊天系统 - 自定义聊天格式,支持跨服聊天功能和私聊系统
  • TAB列表显示 - 可自定义TAB列表中玩家名称的前缀和后缀
  • 数据库支持 - 支持 MySQL 数据库存储玩家信息,使用 HikariCP 连接池
  • PlaceholderAPI集成 - 完美支持 PlaceholderAPI,提供丰富的占位符
  • 优先级系统 - 支持权限组优先级,数字越大优先级越高

主要功能

主要功能

1. 权限组管理

  • 自定义权限组配置 - 支持创建和管理多个权限组
  • 前缀后缀设置 - 可设置每个权限组的前缀和后缀
  • 优先级系统 - 数字越大优先级越高,高优先级会覆盖低优先级
  • 玩家管理 - 提供添加/移除玩家到权限组的命令
  • 权限组列表 - 可查看所有权限组和玩家所属权限组

2. 聊天系统

  • 自定义聊天格式 - 完全可自定义的聊天消息格式
  • 跨服聊天功能 - 支持在BungeeCord网络中跨服务器聊天
  • 私聊系统 - 支持 /msg/reply 命令进行私聊
  • 可配置格式 - 私聊消息格式完全可配置
  • 服务器标识 - 跨服聊天时显示服务器名称

3. TAB列表显示

  • 自定义前缀后缀 - 可自定义TAB列表中玩家名称的前缀和后缀
  • 占位符支持 - 支持各种占位符替换
  • 格式配置 - 可配置的前缀和后缀格式
  • 实时更新 - 权限组变更时TAB列表实时更新

4. 数据库支持

  • MySQL支持 - 支持 MySQL 数据库存储玩家信息
  • 连接池优化 - 使用 HikariCP 连接池提高性能
  • 数据持久化 - 玩家权限组信息持久化存储
  • 自动备份 - 支持数据自动备份和恢复

权限节点

权限节点

权限节点 描述 默认分配
moretitle.admin 允许使用所有MoreTitle管理命令 OP
moretitle.reload 允许重载插件配置 OP
moretitle.group.add 允许添加玩家到权限组 OP
moretitle.group.remove 允许从权限组移除玩家 OP
moretitle.group.list 允许查看权限组列表 OP

权限说明

  • 管理员权限 - 拥有所有管理功能,包括重载配置、权限组管理等
  • 重载权限 - 允许重新加载插件配置文件
  • 权限组管理 - 允许添加、移除玩家和查看权限组信息
  • 默认设置 - 所有管理权限默认分配给OP

命令系统

命令系统

主命令

/moretitle 或 /mt

  • 权限: moretitle.admin(默认OP拥有)
  • 子命令:
    • reload - 重载插件配置
    • group add <玩家> <权限组> - 添加玩家到权限组
    • group remove <玩家> <权限组> - 从权限组移除玩家
    • group list - 查看权限组列表
    • group list <玩家> - 查看玩家的权限组

私聊命令

/msg <玩家> <消息>

  • 别名: /tell, /w, /whisper
  • 功能: 发送私聊消息
  • 权限: 无特殊要求

/reply <消息>

  • 别名: /r
  • 功能: 回复上一个私聊的玩家
  • 权限: 无特殊要求

命令示例

# 重载配置
/moretitle reload

# 添加玩家到权限组
/moretitle group add Steve vip

# 从权限组移除玩家
/moretitle group remove Steve vip

# 查看权限组列表
/moretitle group list

# 查看玩家权限组
/moretitle group list Steve

# 发送私聊
/msg Alex 你好!

# 回复私聊
/reply 收到!

2. 配置

配置文件

配置文件 (config.yml)

# 数据库配置
database:
  enable: false # 是否启用数据库
  host: localhost # 数据库主机地址
  port: 3306 # 数据库端口
  database: moretitle # 数据库名称
  username: root # 数据库用户名
  password: password # 数据库密码
  table-prefix: mt_ # 表前缀

# 服务器配置
server:
  name: "大厅" # 服务器名称,用于跨服聊天
  enable-cross-server-chat: false # 是否启用跨服聊天

# 聊天格式配置
chat:
  format: "{server_prefix}{group_prefix}{player_name}{group_suffix} &f» {message}" # 聊天格式
  server-prefix: "&7[{server_name}]" # 服务器前缀,仅在跨服聊天时显示
  private-message:
    send: "&7[&c我&7 -> &c{receiver}&7] &f{message}" # 发送私聊消息格式
    receive: "&7[&c{sender}&7 -> &c我&7] &f{message}" # 接收私聊消息格式

# 权限组配置
groups:
  default: # 默认权限组
    prefix: "&7[玩家]" # 前缀
    suffix: "" # 后缀
    priority: 0 # 优先级,数字越大优先级越高
  vip:
    prefix: "&e[VIP]"
    suffix: ""
    priority: 10
  admin:
    prefix: "&c[管理员]"
    suffix: ""
    priority: 100

# TAB列表配置
tab:
  enabled: true # 是否启用TAB列表前缀后缀
  prefix-format: "{prefix} " # TAB前缀格式
  suffix-format: " {suffix}" # TAB后缀格式

# 可用变量:
# {prefix} - 玩家权限组前缀
# {suffix} - 玩家权限组后缀
# {player} - 玩家名称
# {server} - 服务器名称

配置说明

  • 数据库配置 - 设置MySQL数据库连接信息和表前缀
  • 服务器配置 - 设置服务器名称和跨服聊天功能
  • 聊天格式 - 自定义聊天消息和私聊消息格式
  • 权限组配置 - 定义各个权限组的前缀、后缀和优先级
  • TAB配置 - 设置TAB列表中玩家名称的显示格式

占位符支持

占位符支持

插件支持 PlaceholderAPI,可以在配置中使用各种占位符:

基础占位符

占位符 描述 示例
{player} 玩家名称 Steve
{server} 服务器名称 大厅
{prefix} 玩家权限组前缀 &e[VIP]
{suffix} 玩家权限组后缀 &c[管理员]
{message} 聊天消息内容 你好!
{sender} 私聊发送者 Alex
{receiver} 私聊接收者 Bob

使用示例

# 聊天格式示例
chat:
  format: "{server_prefix}{group_prefix}{player_name}{group_suffix} &f» {message}"
  
# 私聊格式示例
private-message:
  send: "&7[&c我&7 -> &c{receiver}&7] &f{message}"
  receive: "&7[&c{sender}&7 -> &c我&7] &f{message}"
  
# TAB格式示例
tab:
  prefix-format: "{prefix} "
  suffix-format: " {suffix}"

与其他插件集成

  • PictureCharacters - 可与图形显示插件共同作用
  • PlaceholderAPI - 支持所有PlaceholderAPI变量
  • BungeeCord - 支持跨服务器聊天功能

数据库结构

数据库结构

插件使用 MySQL 数据库存储玩家权限组信息,表结构如下:

players 表(玩家权限组表)

字段名 类型 描述
id INT (主键, 自增) 记录ID
player_uuid VARCHAR(36) 玩家UUID
player_name VARCHAR(16) 玩家名称
group_name VARCHAR(32) 权限组名称
joined_at TIMESTAMP 加入时间
updated_at TIMESTAMP 更新时间

数据库关系

  • players 表存储玩家与权限组的关联关系
  • 支持一个玩家属于多个权限组(优先级最高的生效)
  • 自动记录加入时间和更新时间
  • 支持UUID和玩家名称双重索引

数据库配置

database:
  enable: true # 启用数据库存储
  host: localhost # 数据库主机
  port: 3306 # 数据库端口
  database: moretitle # 数据库名称
  username: root # 用户名
  password: password # 密码
  table-prefix: mt_ # 表前缀

3. 安装使用

安装步骤

安装步骤

1. 下载插件

  • 从官方渠道下载最新版本的 MoreTitle 插件
  • 确保下载的版本与服务器版本兼容(需要 Paper 1.20.1+)

2. 安装依赖

确保服务器已安装以下依赖:

  • Paper 1.20.1+ - 服务端核心
  • PlaceholderAPI - 变量支持(推荐)
  • MySQL - 数据库支持(可选)

3. 配置文件设置

  1. 启动服务器生成配置文件
  2. 修改 config.yml 中的数据库设置(如需要)
  3. 根据需要调整权限组和聊天格式配置
  4. 设置服务器名称和跨服聊天选项

4. 重启服务器

重启服务器使配置生效,插件开始工作。

5. 验证安装

使用 /moretitle group list 命令验证插件是否正确安装。

使用方法

使用方法

权限组管理

  1. 添加玩家到权限组

    /moretitle group add <玩家名> <权限组名>
    

    示例:/moretitle group add Steve vip

  2. 从权限组移除玩家

    /moretitle group remove <玩家名> <权限组名>
    

    示例:/moretitle group remove Steve vip

  3. 查看权限组列表

    /moretitle group list
    
  4. 查看玩家权限组

    /moretitle group list <玩家名>
    

    示例:/moretitle group list Steve

私聊功能

  1. 发送私聊消息

    /msg <玩家名> <消息>
    

    示例:/msg Alex 你好!

  2. 回复私聊消息

    /reply <消息>
    

    示例:/reply 收到!

管理功能

  1. 重载插件配置

    /moretitle reload
    
  2. 查看帮助信息

    /moretitle help
    

配置权限组

  1. 编辑 plugins/MoreTitle/config.yml
  2. groups 部分添加或修改权限组
  3. 使用 /moretitle reload 重新加载配置
  4. 使用命令添加玩家到权限组

故障排除

故障排除

常见问题

Q: 插件无法连接数据库

A: 检查以下设置:

  • 数据库服务器是否运行
  • 数据库连接信息是否正确
  • 数据库用户权限是否足够
  • 防火墙是否阻止连接

Q: 权限组不生效

A: 确保:

  • 玩家已正确添加到权限组
  • 权限组配置正确
  • 优先级设置正确
  • 重启服务器或重载配置

Q: 聊天格式不显示

A: 检查:

  • 聊天格式配置是否正确
  • 占位符语法是否正确
  • 权限设置是否正确
  • 重启服务器使配置生效

Q: 跨服聊天不工作

A: 确保:

  • BungeeCord 网络配置正确
  • 所有子服务器都安装了插件
  • 服务器间通信正常
  • 跨服聊天功能已启用

Q: 私聊功能不工作

A: 检查:

  • 私聊格式配置是否正确
  • 命令权限是否正确
  • 目标玩家是否在线
  • 查看控制台错误信息

日志查看

插件会在控制台输出详细的日志信息,包括:

  • 数据库连接状态
  • 权限组变更记录
  • 聊天消息处理
  • 错误信息

性能优化

  • 合理设置权限组数量
  • 优化数据库查询
  • 定期清理无用数据
  • 监控插件性能指标

4. 注意事项

重要提醒

注意事项

1. 版本要求

  • 插件需要 Paper 1.20.1 或更高版本
  • 使用 Java 17 或更高版本
  • 确保服务端核心版本兼容
  • 测试不同版本的兼容性

2. 数据库要求

  • 如需使用数据库功能,需要 MySQL 数据库
  • 请确保正确配置数据库连接信息
  • 建议定期备份数据库以防止数据丢失
  • 确保数据库用户有足够的权限

3. 权限组管理

  • 仔细配置权限组优先级
  • 定期检查权限组设置
  • 避免权限组冲突
  • 测试权限组功能

4. 性能考虑

  • 大量权限组可能影响性能
  • 建议合理设置权限组数量
  • 定期清理无用数据
  • 监控服务器资源使用情况

5. 安全建议

  • 定期更新插件版本
  • 使用强密码保护数据库
  • 限制数据库用户权限
  • 监控异常活动

6. 兼容性

  • 确保与其他插件的兼容性
  • 测试不同版本的 Minecraft 服务器
  • 备份重要配置
  • 在测试环境中先验证功能

7. 维护建议

  • 定期检查插件更新
  • 监控数据库性能
  • 清理无用的数据
  • 优化配置文件设置

8. 依赖关系

  • Paper 1.20.1+ - 服务端核心要求
  • PlaceholderAPI - 变量支持(推荐)
  • MySQL - 数据库支持(可选)
  • BungeeCord - 跨服功能支持(可选)

9. 开发者信息

插件采用 Java 编写,使用 Maven 构建,依赖于 Paper API 和相关库。主要组件包括:

  • MoreTitle - 主类
  • PlayerManager - 玩家管理
  • DatabaseManager - 数据库管理
  • ChatListener - 聊天监听器
  • PlayerListener - 玩家事件监听器
  • TabListener - TAB列表监听器
  • 各种命令处理类

这个插件为服务器管理员提供了完整的玩家昵称管理和聊天系统解决方案,可以极大地增强服务器的社交体验。